/**
 * \file panic.h
 * \brief Kernel panic, abort, and trace
 * \author Corey Tabaka
 */

/*
   Copyright 2005 Corey Tabaka

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
*/

#ifndef __KERNEL_PANIC_H__
#define __KERNEL_PANIC_H__

/*
 * Kernel panic. Clears interrupts, prints message, and halts the processor.
 * Defined in panic.asm
 */
#ifdef __cplusplus
extern "C" {
#endif

	void panic(const char *fmt, ...) __attribute__ ((noreturn,format(printf,1,2)));
	void abort(const char *fmt, ...) __attribute__ ((noreturn,format(printf,1,2)));
	void trace(void);
	
	// macro to clarify that the reason for panicking is a bug
	#define bug(msg...) panic("BUG: "msg)

#ifdef __cplusplus
}
#endif

#endif
